Preprocessor

The function of the C-preprocessor is to merge your program with
user and system declarations and macros. In order to use the Macintosh
Toolbox, you will need to obtain the MPW include files from ftp.apple.com
or from some other compiler. Due to copyright reasons it is not possible
to distribute these include files with this package. The previous version
of this program, available at the same site that you got this, required the
header files to be filtered into a special gcc syntax. This is no longer
necessary. You can use the include files as is. Just select the appropriate
directory using the GCC/Search Paths menu option.

Don't be surprised if you get various warnings and/or errors with these
header files. The checking with gcc is stricter than other compilers, also
some obscure Apple data types may not work with this compiler.

To use the pre-processor, bring your C-source window to the front
and invoke the GCC/Preprocess option, a new window should appear
with the .c changed to a .i, also an error window may open. You should
only proceed to the next stage, compilation, if there are no errors.

If you are curious, you will notice that there are loads of blank lines in the
.i file. This is because the preprocessor preserves line numbering so that 
any compilation errors will relate back to the appropriate source line
number. However you will need to use an external editor such as
BBEdit-2.2.2 (freeware) to zoom in on a given source text line.
Because of the wide availability of mac compatible editors, the built-in
editor offers minimal functionality. However, before you ask, it does 
allow you to view output files of over 32K. In this case the file will
be static text (view only, no editing)